home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 September / Macworld (1997-09).dmg / Serious Software / Cherwell Scientific Demos / pro Fit / pro Fit 5.0 demo (fpu).sea / pro Fit 5.0 demo (fpu) / Notes / 3D plot 2.0.0 - read me next >
Text File  |  1996-07-24  |  5KB  |  99 lines
  1. Plot3D, version 2.0.0
  2.  
  3.  
  4. What is it?
  5. Plot3D is a plug-in module for pro Fit 5.0. It provides commands for generating 3D-plots from data and functions. Source code included.
  6.  
  7. Requirements
  8. To run Plot3D, you need the PowerMac version of pro Fit 5.0 or later. If you don't have pro Fit 5.0, you can download a fully working trial version from
  9. <http://www.chwerwell.com/cherwell/>
  10. Furthermore, you need a Power Macintosh and Quickdraw 3D. Quickdraw 3D is a 3D-graphing package from apple. It can be downloaded for free from Apple's internet sites, such as
  11. <http://quickdraw3d.apple.com/>
  12. Since 3D graphing requires large amount of memory, we recommend that you assign at least 4 MB to pro Fit.
  13.  
  14. Installation
  15. Once you have installed pro Fit 5.0, you must place the following files into one folder:
  16.     Plot3D
  17.     Text3DLib
  18.     Triangulate.Lib
  19. (all these files are enclosed).
  20. Then start pro Fit, choose "Load Module..." from the "Misc" menu and select Plot3D, or simply double-click the file Plot3D.
  21.  
  22. How to use it?
  23. When you load Plot3D, it installs the following commands in the "Misc" menu:
  24.  - Plot3D_Data_XY
  25.     Plots data. The data's x-, y- and z-coordinates must be arranged in
  26.     three rows in a data window.
  27.  - Plot3D_Data_RowCol
  28.     Plots data. The data's x- and y- coordinates are the column and row
  29.     numbers of the data window, the z-coordinates the values in the data
  30.     window.
  31.  - Plot3D_Function
  32.     Plots a function.
  33. Choose one of these commands to create a graph. The graph appears in a graph editing window. You can then use the Save and Edit menus to edit the graph. When you are through, click Done for placing a picture of the graph in a drawing window.
  34.  
  35. How do I compile it?    
  36. The sources of the module and a project file for CodeWarrior 9 are enclosed. Note that we also enclose new versions of the files ModuleUtilities.c and ModuleUtilites.h - these files replace the ones that came with pro Fit 5.0.0 and pro Fit 5.0t.
  37. When compiling the project, you may have to add/correct Access Paths depending on where you have stored the various header files.
  38.  
  39. Customizing textures
  40. This version of Plot3D allows you to apply a texture to the plotted surface instead of using a single color. There are various predefined textures that you can use. If you are familiar with ResEdit, you can also add your own textures: The textures are stored in Plot3D as resources of type PICT with  IDs starting from 31000. You can paste your own PICT resources as textures. Note: the resource IDs of the texture PICTs must start from 31000 and there must be no gaps in the numbers. There can be up to 100 textures.
  41.  
  42. Known problems
  43. The amount of memory required for plotting substantially depends on the number of points in your plot. When plotting around 10000 (e.g. 100 x 100) points, you should have at least 16 MB of free memory, for plotting 65000 points (e.g. 256 x 256 points), you need six times as much! When running out of memory, portions of memory are swapped out to disk, which drastically affects speed and system stability. Therefore, when working on large data sets, try to reduce the amount of data (e.g. by using the command "Data Reduction") before plotting.
  44.  
  45. Version history
  46.  
  47. Changes between 2.0.0 and 1.1.0
  48.  
  49. - 3D plots can now have ticks, labels and axis names. These items
  50.   can appear at each axis line and frame line.
  51.  
  52. - Surfaces can be textured.
  53.  
  54. - There's a new surface style: Basic. This style suppresses all shadowing
  55.    and ignores the position of the lights.
  56.  
  57. - You can now save and load the style of a graph - this provides a mechanism
  58.   for generating several graphs having the same settings for axes, labels,
  59.   camera, etc. The commands for loading, saving and deleting styles are
  60.   found in the File menu.
  61.  
  62. - All 3D plotting programs (for functions, xyz-data, Z(row,col)-data)
  63.   have been moved into a single module.
  64.  
  65. - Picture options are saved in automatically restored when you link the
  66.   module the next time.
  67.  
  68. - Bug fixes.
  69.  
  70. Changes between version 1.1.0 and version 1.0.0:
  71.  
  72. - Added the module "Plot3D Data Z(row,col)". This is a module
  73.   for 3D plotting of data. It takes a two-dimensional array
  74.   as input.
  75.  
  76. - Added a menu item "Camera & Illumination" for setting
  77.   the projection (parallel, point) and the location
  78.   of the illuminating lights.
  79.  
  80. - PICT Options now allows to set the depth of the PICTs
  81.  
  82. - PICT Options now allows to make a picture "transparent".
  83.   A transparent picture has the transfermode srcOr instead
  84.   of srcCopy
  85.  
  86. - The relative lengths of the axes can be set in the
  87.   Axes dialog.
  88.  
  89. - A frame (box) can be added by checking a checkbox in the axes
  90.   dialog.
  91.  
  92. - When creating a pict, the modules now first try to use temporary
  93.   memory before using the heap. This reduces the number of
  94.   messages "not enough memory"
  95.  
  96. - The main window shows the version number of the module at its
  97.   lower left corner.
  98.  
  99.